home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro72 / sho.doc < prev    next >
Encoding:
Text File  |  1993-06-17  |  7.5 KB  |  165 lines
  1. Documentation for SHOWDISK by Dwayne Melancon, 76417,600 (CIS).
  2.  
  3. As featured in "Compute!" magazine (April, 1990), and the book "DOS
  4. PowerTools, Volume 6" (1993).
  5.  
  6. What does it do?
  7. ================
  8. This program provides a quick, easy way to check the space usage for a hard
  9. or floppy disk drive.  It provides a "gas gauge" style usage graph (character
  10. based) that you can read at a glance.  It also provides byte figures (in
  11. kilobytes or Megabytes, whichever is appropriate) on the space allocated and
  12. the space available.
  13.  
  14. SYNTAX:   SHO [drive letter] [/?] [/M] [/1] [/2]
  15.  
  16.           If no drive letter is specified, the current drive will be used.
  17.           A colon is not necessary but it won't hurt anything, either.
  18.           Command line switches are as follows:
  19.  
  20.           /? brings up a page of help information.
  21.  
  22.           /M forces monochrome "colors" for better visibility on composite
  23.              monitors and laptops.  Monochrome monitors are automatically
  24.              detected.  Monochrome can also be forced by using the
  25.              command "SET SHO=M" from a DOS prompt or AUTOEXEC.BAT file.
  26.  
  27.           /1 tells SHO to consider a megabyte to equal 1,024,000 bytes
  28.              when calculating statistics. This is the default value, and
  29.              can also be forced with the command "SET SHO=1" from a DOS
  30.              prompt or AUTOEXEC.BAT file.
  31.  
  32.           /2 tells SHO to consider a megabyte to equal 1,000,000 bytes
  33.              when calculating statistics.  This can also be forced with
  34.              the command "SET SHO=2" from a DOS prompt or AUTOEXEC.BAT
  35.              file.
  36.  
  37. Note: Environment variables (SET= commands) can be used to force any of
  38.       the command line switches above to be used as defaults.  More than
  39.       one setting can be combined.  For example, if you want to use
  40.       Monochrome attributes and 1,000,000 byte megabytes as your
  41.       default, you could put the command "SET SHO=M2" in your
  42.       AUTOEXEC.BAT file.
  43.  
  44. Why use it?
  45. ===========
  46. I wrote this program because I was tired of waiting for CHKDSK to run when
  47. all I wanted to do was get a quick check on how much of my disk was in use.
  48.  
  49. This utility will not give exactly the same readings as CHKDSK; the DOS
  50. CHKDSK utility deals in exact bytes, while SHOWDSK deals in allocated
  51. clusters.  What's the difference?  The bytes in CHKDSK indicate the number
  52. bytes you would get if you added up the exact file sizes of all of the
  53. files on your disk.  My utility tells you how many bytes have been ALLOCATED
  54. to those files.  In other words, if you had a standard 30 Mb hard disk
  55. using DOS 3.3 (512 bytes per sector, 4 sectors per cluster), CHKDSK would
  56. tell you that you had 1 byte in 1 user file.  While this is true, CHKDSK
  57. DOESN'T tell you that DOS can only allocate space on this disk in blocks of
  58. 2048 bytes -- it makes you think you have 2047 more usable bytes than you
  59. actually have.  My utility would tell you that you had 2048 bytes allocated
  60. on your disk -- more accurate, eh?
  61.  
  62. Using allocated clusters rather than actual file sizes not only gives a more
  63. accurate indication of the space used on your drive, it makes the program
  64. faster.
  65.  
  66. Why the two choices for megabyte values?
  67. ========================================
  68. Previous versions of SHO used 1,024,000 bytes as the value for a
  69. megabyte.  This is more of a "purist" value, since it is closer to what
  70. DOS actually considers a megabyte.  However, some of my testers prefer
  71. using 1,000,000 bytes for megabytes because it makes things look
  72. "cleaner" when SHO summarizes the space usage in "xx.xx Mb"
  73.  
  74. Try 'em both, see which you like best.  The only figures that will
  75. change are the "Space in use" and "Space available" numbers just beneath
  76. the bar graph.
  77.  
  78. Upgrading from earlier versions:
  79. ================================
  80. The latest version of SHO is an EXE file.  If you have a previous
  81. version that was "SHO.COM", you must delete it for this one to run since
  82. DOS will execute a COM file before an EXE if both exist in the same
  83. directory.
  84.  
  85.  
  86. DISCLAIMER!!!
  87. =============
  88. SHOWDISK has run successfully on everything I have tried it on.  It does
  89. not write to any disks.  It reads things.  HOWEVER, I have written this
  90. program for the sake of convenience only and will not take
  91. responsibility for any incompatibilities, damage, loss of data or hair,
  92. or any damages, consequential or otherwise resulting from the use of
  93. this program.  When you use this program, you agree not to get mad at
  94. me, say mean things about me, sue me or any other negative things, as I
  95. am offering this program as a utility that has been useful to me that I
  96. feel others may like as well.
  97.  
  98. Scary?  Hey, this is a litigious society and I want to make it quite
  99. clear that when you use this program, you do so at your own risk.
  100. Please keep in mind, however, that the functions performed by this
  101. program are quite tame and benign and that it has never been responsible
  102. for any data loss that I know of. I use it daily, as do many of my
  103. friends/testers.
  104.  
  105.                            ***************************
  106.  
  107. REGISTRATION REQUIREMENTS:
  108. ==========================
  109. This program is free.  Distribute it as you wish.  I only ask that you
  110. keep this file (SHO.DOC) with the program when you give it away, and
  111. that you send me a postcard from your city (with your city's name on
  112. it).  If you don't have one, go to your local Holiday Inn and acquire
  113. one.  Please include any comments you have about the program, and tell
  114. me where you got the program from.
  115.         Dwayne A. Melancon
  116.         7528 Barringer Road
  117.         Baton Rouge, LA  70817
  118.  
  119. Remember - you DON'T have to pay to use this program (however, if you
  120. want to send a few bucks, I'll gladly accept it), so I'd really
  121. appreciate it if you'd take the time to send me a postcard.
  122.  
  123. Comments on the program are welcome.  Updates will be done, but no promises
  124. can be made as to when -- I do this stuff in my spare time, which has a
  125. tendency to be allocated FOR me, rather than BY me.
  126.  
  127.  
  128. Revision history (reverse order):
  129. =================================
  130. Version 2.6  - Added /1, /2, and /? command line switches, and variable
  131.                 megabyte value.
  132.  
  133. Version 2.5  - Added support for environment variables
  134.                 to define defaults.
  135.  
  136. Version 2.4  - Added /M (force monochrome) option.
  137.  
  138. Version 2.3d+- The "plus" is for a shadow I added behind the bar to make
  139.                 the readout look kind of "3-D" (hence the "3d").
  140.  
  141. Version 2.3  - Back to an EXE, folks.  I found a way to make it smaller
  142.                 and a bit faster.  The technique requires that the file
  143.                 be an EXE because it doesn't work in Turbo C's Tiny
  144.                 memory model.
  145.  
  146. Version 2.1  - Played around with "exploding" windows.  This version was
  147.                 only used by a few people to get a "user response".  We
  148.                 judged it to be "neat", but it makes the program seem
  149.                 slower and makes it a little bit larger.
  150.  
  151. Version 2.0  - Switched windowing methods to make things a bit more
  152.                 efficient space- and memory-wise.
  153.  
  154. Version 1.4  - Provisions made for very large hard drives and network
  155.                 drives (special thanks to Randol Tigrett at PC
  156.                 Magazine's LAN Labs for his help), and some diagnostic
  157.                 routines were added.
  158.  
  159. Version 1.2  - Changed from EXE to COM file.
  160.  
  161. Version 1.1  - Added video mode detection functions to make display more
  162.                 readable on monochrome monitors.
  163.  
  164. --- EOF ---
  165.